---
title: oras restore
sidebar_position: 220
warning: Do NOT modify this generated file
---

# oras restore

[Experimental] Restore artifacts to a registry from an OCI image layout, which can be either a directory or a tar archive. 

```bash
oras restore [flags] --input <path> <registry>/<repository>[:<ref1>[,<ref2>...]]
```

## Examples

Restore a single artifact from a tar archive:

```bash
oras restore --input hello.tar localhost:5000/hello:v1
```

Restore a single artifact from a directory:

```bash
oras restore --input hello localhost:5000/hello:v1
```

Perform a dry run without actually uploading artifacts:

```bash
oras restore --input hello --dry-run localhost:5000/hello:v1
```

Restore multiple specific tags:

```bash
oras restore --input hello localhost:5000/hello:v1,v2
```

Restore all tagged artifacts:

```bash
oras restore --input hello localhost:5000/hello
```

Exclude referrers when restoring artifacts:

```bash
oras restore --input hello --exclude-referrers localhost:5000/hello
```

Use Referrers API for discovering referrers:

```bash
oras restore --input hello --distribution-spec v1.1-referrers-api localhost:5000/hello
```

Use Referrers Tag Schema for discovering referrers:

```bash
oras restore --input hello --distribution-spec v1.1-referrers-tag localhost:5000/hello
```

Restore to an insecure registry:

```bash
oras restore --input hello --insecure localhost:5000/hello:v1
```

Restore to a plain HTTP registry (no TLS):

```bash
oras restore --input hello --plain-http localhost:5000/hello:v1
```

Set custom concurrency level:

```bash
oras restore --input hello --concurrency 6 localhost:5000/hello:v1
```

## Options

```
      --ca-file string                             server certificate authority file for the remote registry
      --cert-file string                           client certificate file for the remote registry
      --concurrency int                            concurrency level (default 5)
  -d, --debug                                      output debug logs (implies --no-tty)
      --distribution-spec string                   [Preview] set OCI distribution spec version and API option for target. Options: v1.1-referrers-tag, v1.1-referrers-api
      --dry-run                                    simulate the restore process without actually uploading any artifacts
      --exclude-referrers                          restore artifacts excluding their referrers
  -H, --header stringArray                         add custom headers to requests
  -h, --help                                       help for restore
      --identity-token string                      registry identity token
      --identity-token-stdin                       read identity token from stdin
      --input string                               path to the OCI layout, either a tar archive (*.tar) or a directory
      --insecure                                   allow connections to SSL registry without certs
      --key-file string                            client private key file for the remote registry
      --no-tty                                     [Preview] disable progress bars
  -p, --password string                            registry password or identity token
      --password-stdin                             read password from stdin
      --plain-http                                 allow insecure connections to registry without SSL check
      --registry-config path                       path of the authentication file for registry
      --resolve host:port:address[:address_port]   customized DNS for registry, formatted in host:port:address[:address_port]
  -u, --username string                            registry username
```
